Add some more docs on interactive search.

2005-04-05  Matthias Clasen  <mclasen@redhat.com>

	* gtk/gtktreeview.c (gtk_tree_view_set_search_column): Add some
	more docs on interactive search.

diff --git a/ChangeLog b/ChangeLog
index b3b185ac53710ec840bf8bb83ac128e1623733fc..bc5ec74ca5d97f33a8493c73b3c51435245d9320 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,8 @@
+2005-04-05  Matthias Clasen  <mclasen@redhat.com>
+
+       * gtk/gtktreeview.c (gtk_tree_view_set_search_column): Add some
+       more docs on interactive search.
+
 2005-04-05  Tor Lillqvist  <tml@novell.com>
 
        * gdk/win32/gdkvisual-win32.c (_gdk_visual_init): Handle 16 colour

diff --git a/ChangeLog.pre-2-10 b/ChangeLog.pre-2-10
index b3b185ac53710ec840bf8bb83ac128e1623733fc..bc5ec74ca5d97f33a8493c73b3c51435245d9320 100644 (file)
--- a/ChangeLog.pre-2-10
+++ b/ChangeLog.pre-2-10
@@ -1,3 +1,8 @@
+2005-04-05  Matthias Clasen  <mclasen@redhat.com>
+
+       * gtk/gtktreeview.c (gtk_tree_view_set_search_column): Add some
+       more docs on interactive search.
+
 2005-04-05  Tor Lillqvist  <tml@novell.com>
 
        * gdk/win32/gdkvisual-win32.c (_gdk_visual_init): Handle 16 colour

diff --git a/ChangeLog.pre-2-8 b/ChangeLog.pre-2-8
index b3b185ac53710ec840bf8bb83ac128e1623733fc..bc5ec74ca5d97f33a8493c73b3c51435245d9320 100644 (file)
--- a/ChangeLog.pre-2-8
+++ b/ChangeLog.pre-2-8
@@ -1,3 +1,8 @@
+2005-04-05  Matthias Clasen  <mclasen@redhat.com>
+
+       * gtk/gtktreeview.c (gtk_tree_view_set_search_column): Add some
+       more docs on interactive search.
+
 2005-04-05  Tor Lillqvist  <tml@novell.com>
 
        * gdk/win32/gdkvisual-win32.c (_gdk_visual_init): Handle 16 colour

diff --git a/gtk/gtktreeview.c b/gtk/gtktreeview.c
index 84c5f7a94687098c51ca4c38100a9445ab8ecf75..cdbe3b488f8613d8b66e038eae24f3f94d44025e 100644 (file)
--- a/gtk/gtktreeview.c
+++ b/gtk/gtktreeview.c
@@ -12135,7 +12135,10 @@ gtk_tree_view_set_destroy_count_func (GtkTreeView             *tree_view,
  * @enable_search: %TRUE, if the user can search interactively
  *
  * If @enable_search is set, then the user can type in text to search through
- * the tree interactively.
+ * the tree interactively (this is sometimes called "typeahead find").
+ * 
+ * Note that even if this is %FALSE, the user can still initiate a search 
+ * using the "start-interactive-search" key binding.
  */
 void
 gtk_tree_view_set_enable_search (GtkTreeView *tree_view,
@@ -12156,7 +12159,8 @@ gtk_tree_view_set_enable_search (GtkTreeView *tree_view,
  * gtk_tree_view_get_enable_search:
  * @tree_view: A #GtkTreeView
  *
- * Returns whether or not the tree allows interactive searching.
+ * Returns whether or not the tree allows to start interactive searching 
+ * by typing in text.
  *
  * Return value: whether or not to let the user search interactively
  */
@@ -12191,8 +12195,13 @@ gtk_tree_view_get_search_column (GtkTreeView *tree_view)
  * @column: the column of the model to search in
  *
  * Sets @column as the column where the interactive search code should
- * search in.  Additionally, turns on interactive searching. Note that
- * @column refers to a column of the model.
+ * search in. 
+ * 
+ * If the sort column is set, users can use the "start-interactive-search"
+ * key binding to bring up search popup. The enable-search property controls
+ * wether simply typing text will also start an interactive search.
+ *
+ * Note that @column refers to a column of the model. 
  */
 void
 gtk_tree_view_set_search_column (GtkTreeView *tree_view,